<?php

/**
 * This code was generated by
 * \ / _    _  _|   _  _
 * | (_)\/(_)(_|\/| |(/_  v1.0.0
 * /       /
 */

namespace Twilio\Rest\Preview\Sync\Service;

use Twilio\Exceptions\TwilioException;
use Twilio\InstanceContext;
use Twilio\Rest\Preview\Sync\Service\Document\DocumentPermissionList;
use Twilio\Serialize;
use Twilio\Values;
use Twilio\Version;

/**
 * PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
 *
 * @property \Twilio\Rest\Preview\Sync\Service\Document\DocumentPermissionList documentPermissions
 * @method \Twilio\Rest\Preview\Sync\Service\Document\DocumentPermissionContext documentPermissions( string $identity )
 */
class DocumentContext extends InstanceContext {
	protected $_documentPermissions = null;

	/**
	 * Initialize the DocumentContext
	 *
	 * @param \Twilio\Version $version Version that contains the resource
	 * @param string $serviceSid The service_sid
	 * @param string $sid The sid
	 *
	 * @return \Twilio\Rest\Preview\Sync\Service\DocumentContext
	 */
	public function __construct( Version $version, $serviceSid, $sid ) {
		parent::__construct( $version );

		// Path Solution
		$this->solution = array( 'serviceSid' => $serviceSid, 'sid' => $sid, );

		$this->uri = '/Services/' . rawurlencode( $serviceSid ) . '/Documents/' . rawurlencode( $sid ) . '';
	}

	/**
	 * Fetch a DocumentInstance
	 *
	 * @return DocumentInstance Fetched DocumentInstance
	 * @throws TwilioException When an HTTP error occurs.
	 */
	public function fetch() {
		$params = Values::of( array() );

		$payload = $this->version->fetch(
			'GET',
			$this->uri,
			$params
		);

		return new DocumentInstance(
			$this->version,
			$payload,
			$this->solution['serviceSid'],
			$this->solution['sid']
		);
	}

	/**
	 * Deletes the DocumentInstance
	 *
	 * @return boolean True if delete succeeds, false otherwise
	 * @throws TwilioException When an HTTP error occurs.
	 */
	public function delete() {
		return $this->version->delete( 'delete', $this->uri );
	}

	/**
	 * Update the DocumentInstance
	 *
	 * @param array $data The data
	 *
	 * @return DocumentInstance Updated DocumentInstance
	 * @throws TwilioException When an HTTP error occurs.
	 */
	public function update( $data ) {
		$data = Values::of( array( 'Data' => Serialize::jsonObject( $data ), ) );

		$payload = $this->version->update(
			'POST',
			$this->uri,
			array(),
			$data
		);

		return new DocumentInstance(
			$this->version,
			$payload,
			$this->solution['serviceSid'],
			$this->solution['sid']
		);
	}

	/**
	 * Magic getter to lazy load subresources
	 *
	 * @param string $name Subresource to return
	 *
	 * @return \Twilio\ListResource The requested subresource
	 * @throws \Twilio\Exceptions\TwilioException For unknown subresources
	 */
	public function __get( $name ) {
		if ( property_exists( $this, '_' . $name ) ) {
			$method = 'get' . ucfirst( $name );

			return $this->$method();
		}

		throw new TwilioException( 'Unknown subresource ' . $name );
	}

	/**
	 * Magic caller to get resource contexts
	 *
	 * @param string $name Resource to return
	 * @param array $arguments Context parameters
	 *
	 * @return \Twilio\InstanceContext The requested resource context
	 * @throws \Twilio\Exceptions\TwilioException For unknown resource
	 */
	public function __call( $name, $arguments ) {
		$property = $this->$name;
		if ( method_exists( $property, 'getContext' ) ) {
			return call_user_func_array( array( $property, 'getContext' ), $arguments );
		}

		throw new TwilioException( 'Resource does not have a context' );
	}

	/**
	 * Provide a friendly representation
	 *
	 * @return string Machine friendly representation
	 */
	public function __toString() {
		$context = array();
		foreach ( $this->solution as $key => $value ) {
			$context[] = "$key=$value";
		}

		return '[Twilio.Preview.Sync.DocumentContext ' . implode( ' ', $context ) . ']';
	}

	/**
	 * Access the documentPermissions
	 *
	 * @return \Twilio\Rest\Preview\Sync\Service\Document\DocumentPermissionList
	 */
	protected function getDocumentPermissions() {
		if ( ! $this->_documentPermissions ) {
			$this->_documentPermissions = new DocumentPermissionList(
				$this->version,
				$this->solution['serviceSid'],
				$this->solution['sid']
			);
		}

		return $this->_documentPermissions;
	}
}